home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / INFO / RBHELP31.ZIP / HELP.DOC < prev    next >
Text File  |  1991-03-15  |  16KB  |  463 lines
  1.  
  2.  
  3.  
  4.      HELP(1)                  MS-DOS utilities                  HELP(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           HELP - obtain help on DOS commands
  10.  
  11.      SYNOPSIS
  12.           help [ -1facpbqhP ] [ -i[n] ] [ -k|K keyword ...] [keyword
  13.           ... ]
  14.  
  15.      DESCRIPTION
  16.           Help is a program to retrieve and display entries from a
  17.           help file. It can operate in a full screen interactive
  18.           browsing mode, or a command line mode which writes only to
  19.           standard output and should work on generic MSDOS computers.
  20.           The helpfiles are pure ascii and can easily be edited and
  21.           extended for local variations in commands.
  22.  
  23.      INTERACTIVE HELP
  24.           If help is entered without any commands specified, it enters
  25.           a full screen interactive help browsing mode.  A window is
  26.           placed on the screen with a sorted list of all available
  27.           help entries.  There is always one entry highlighted, and
  28.           pressing <return> will retrieve help entry for this item.
  29.           If environment variable PAGER is defined, it is assumed to
  30.           be a program to be used for displaying the help entry,
  31.           otherwise the entry is copied directly to the screen.
  32.           Options allow the action to be customised for you favourite
  33.           pager.  A program used for the PAGER must be able to read
  34.           from a pipe.  Selection from the list continues until <ESC>
  35.           is pressed.
  36.  
  37.           NOTE:  use of a PAGER variable may slow the response.  This
  38.           can be helped by placing the PAGER program in a RAM disk,
  39.           and the path set to include this. The command processor
  40.           (COMMAND.COM or other) is not used for this (PAGER is
  41.           executed directly) When interactive mode is used, the screen
  42.           will be saved and restored after use.  In addition, the
  43.           temporary file necessary for this operation may be placed in
  44.           a RAM disk by setting variable TMPDIR or TMP to a suitable
  45.           location.
  46.  
  47.           The following keys are recognised in interactive mode:
  48.  
  49.           <return>
  50.                select the current item <space>
  51.  
  52.           <up>
  53.                move current line up or down, scrolling as needed
  54.                <down>
  55.  
  56.           <home>
  57.                jump to beginning and end of list, respectively <end>
  58.  
  59.           <pageup> <pagedown>
  60.                scroll the list one window at a time
  61.  
  62.  
  63.      Page 1                                           (printed 2/15/91)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      HELP(1)                  MS-DOS utilities                  HELP(1)
  71.  
  72.  
  73.           A-Z
  74.                alphabetic keys will scroll the list to the first entry
  75.                beginning with the letter you type, or the following
  76.                entry if none matches
  77.  
  78.           F1
  79.                pop up a help window describing key actions
  80.  
  81.           F2
  82.                toggle between displaying name, or full synopsis line
  83.  
  84.           F3
  85.                toggle synopsis line on current item only
  86.  
  87.           F4
  88.                extract a list of cross references from the current
  89.                item, and open a new selection window.  This can be
  90.                used recursively
  91.  
  92.           F10
  93.                window goes into move/resize mode.  Use arrow keys to
  94.                move it, shift-arrows to resize left and bottom edges,
  95.                <esc> or F10 to continue (see below)
  96.  
  97.           <ESC>
  98.                Exit the program and restore screen
  99.  
  100.           Moving/Resizing the Window:
  101.           The window containing the list of keywords can be moved or
  102.           resized by pressing F10.  This ability is for the benefit of
  103.           other programs that call help as a child process, with a
  104.           custom help file.  The window can be moved and resized with
  105.           the following keys:
  106.  
  107.           arrow keys:
  108.                move window 1 space at a time in the appropriate
  109.                direction
  110.  
  111.           control-arrow keys:
  112.                move window to extreme edge of screen in the
  113.                appropriate direction
  114.  
  115.           shift-arrow keys
  116.                resize by dragging right and bottom edges of the window
  117.  
  118.           control-shift-arrow keys
  119.                resize by moving right and bottom edges maximum
  120.                possible distance
  121.  
  122.           <ESC>
  123.                redraw window in the current position and continue with
  124.                program
  125.  
  126.           F10
  127.  
  128.  
  129.      Page 2                                           (printed 2/15/91)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      HELP(1)                  MS-DOS utilities                  HELP(1)
  137.  
  138.  
  139.                redraw window in the current position and continue with
  140.                program, but attempt to "lock" window position so that
  141.                a subsequent call to this program will use the new
  142.                window position.  This function uses the
  143.                "Interapplication Communication Area" (ICA) in the BIOS
  144.                data block. If any other program is also using the ICA,
  145.                help will NOT overwrite it's contents.  The ICA may
  146.                contain garbage when the machine is first booted, so a
  147.                small program (clearica.com) is provided to fill the
  148.                ICA with zeroes.  The ICA is not documented in the PS/2
  149.                BIOS and this function may not work.  Using F10 should
  150.                not cause problems with the PS/2, but clearica may
  151.                cause problems.  The sub-windows use with the F4 (cross
  152.                reference) command may be moved but not locked.
  153.  
  154.      OPTIONS (apply to interactive mode only)
  155.  
  156.           -c
  157.                screen clear between each display.  Use this if you
  158.                specify a pager which does not clear the screen before
  159.                starting.
  160.  
  161.           -K key key ...
  162.                apropos keyword (see below) with interactive browsing.
  163.                The list displayed for selection contains only those
  164.                items which contain one of the keywords in the
  165.                synopsis.
  166.  
  167.           -p
  168.                pauses after each display. Use this if you specify a
  169.                pager that does not pause at the end of the file (e.g.
  170.                DOS MORE)
  171.  
  172.           -q
  173.                quiet mode - flash instead of beeping
  174.  
  175.           -b
  176.                bios used for screen output instead of directvideo (use
  177.                if compatiblity problems arise with default action)
  178.  
  179.      COMMAND LINE HELP
  180.           If the format help command is used, then the helpfile is
  181.           searched for "command", and if found, it is printed to
  182.           standard output (or piped through program %PAGER). Multiple
  183.           commands may be listed and they will be searched for in
  184.           order.
  185.  
  186.           If the format help -k keyword is used, the 1-line synopses
  187.           for each help entry are searched for "keyword" and all those
  188.           that match are copied to standard output.
  189.  
  190.           The command line help uses pure DOS i/o and should work on
  191.           any generic MS-DOS machine, including non-IBM compatibles.
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 2/15/91)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      HELP(1)                  MS-DOS utilities                  HELP(1)
  203.  
  204.  
  205.      OPTIONS (apply to non-interactive mode)
  206.  
  207.           -i
  208.                Print index of entries in help file.  If followed by a
  209.                number <n>, print <n> keywords per line (default 5).
  210.  
  211.           -1
  212.                Print single file index of entries in help file, with
  213.                no header
  214.  
  215.           -k key key ...
  216.                Print synopsis of all entries related to <keyword>. All
  217.                command line arguments after -k are taken to be
  218.                keywords for synopsis search rather than entries to
  219.                display full text for.  The synopsis search is
  220.                simpleminded, no regular expressions or boolean
  221.                combinations of keywords.
  222.  
  223.           -P
  224.                Pipe output through program %PAGER if defined.  This is
  225.                always used for interactive selection, and may be
  226.                applied to command line arguments with the -P option.
  227.                This is equivalent to "help command | %PAGER"
  228.  
  229.           -f
  230.                Force rebuild of index files
  231.  
  232.           -h
  233.                Print 1 page summary of program
  234.  
  235.           -a
  236.                Ansi_mode.  Do NOT enter interactive mode if no
  237.                commands are listed (for use on machines for which this
  238.                causes trouble).  If no commands are listed, then
  239.                "HELP" is looked up instead.
  240.  
  241.      DESCRIPTION of HELPFILES
  242.           The helpfile consists of one or more ascii files, with the
  243.           index words (and aliases) marked as explaied below.  The
  244.           files are treated effectively as though concatenated.  An
  245.           index is built and stored in a separate file whenever help
  246.           detects that the index is out of date with respect to the
  247.           helpfile.  The helpfile may be edited with any text editor.
  248.           The file supplied has brief descriptions of most of the
  249.           MSDOS 4.01 and earlier commands.  A 1-line description of
  250.           every help entry is also stored in the index file. This may
  251.           be searched for keywords by using the "apropos" command:
  252.           help -k keyword
  253.  
  254.           The commands and keywords are not case sensitive.  All
  255.           output is to standard output which may be redirected to a
  256.           file or printer.  Some of the longer entries exceed one
  257.           screen and may be piped through "more" or any other pager.
  258.  
  259.  
  260.  
  261.      Page 4                                           (printed 2/15/91)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      HELP(1)                  MS-DOS utilities                  HELP(1)
  269.  
  270.  
  271.           The default directory for the help file is the directory in
  272.           which the executable (help.exe) is located.  This may be
  273.           overridden by setting the environment variable HELPDIR
  274.  
  275.           The default name for the help file is "helpfile".  This may
  276.           be overridden by setting the environment variable HELPFILE.
  277.           HELPFILE may contain a list of file names separated by ";"
  278.           and HELP will cycle through each in turn. This allows help
  279.           files for different types of programs to be maintained in
  280.           logical groupings, but searched as if they were a single
  281.           file.  They must all reside in the same directory.  If any
  282.           files are not present, a diagnostic will be displayed but
  283.           the others will be processed.
  284.  
  285.           The index file for each help file is created by appending
  286.           .idx to the data file name.  The data file should therefore
  287.           have no extension.
  288.  
  289.           The format for the help files is:
  290.           keyword [,alias ,alias ...] [#xref #xref ...]
  291.           keyword - 1 line description to be used by the -k option
  292.           ...
  293.           any number of lines of text, up to EOF or next # at start of
  294.           line ...
  295.  
  296.  
  297.           keyword
  298.                - primary index for this help entry
  299.  
  300.           alias
  301.                - alternate index terms for this help entry
  302.  
  303.           #xref
  304.                - keywords prepended by "#" are cross-references used
  305.                by the F4 command in interactive mode. All items on the
  306.                index line are space or comma delimited, and the line
  307.                may be up to 134 characters.
  308.  
  309.           In all of the descriptions of command usage:
  310.  
  311.           [brackets]
  312.                indicates optional items.
  313.  
  314.                indicates that the previous parameter may be repeated.
  315.  
  316.           d:
  317.                represents a valid drive letter (with colon)
  318.  
  319.           path
  320.                represents a directory path
  321.  
  322.           filename
  323.                is a DOS filename (with extension)
  324.  
  325.  
  326.  
  327.      Page 5                                           (printed 2/15/91)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      HELP(1)                  MS-DOS utilities                  HELP(1)
  335.  
  336.  
  337.           filespec
  338.                is a DOS filename optionally with "*" and "?" wildcards
  339.  
  340.           nnn
  341.                is generally a numeric parameter to be supplied
  342.  
  343.           The help files use the format in the MKS toolkit help, of
  344.           which this was originally a clone.  See the documentation
  345.           file for more information
  346.  
  347.      FILES
  348.           helpfile default datafile containing help info
  349.           helpfile.idx default index file
  350.           HELPDIR Environment variable - directory for helpfile
  351.           HELPFILE Environment variable - alternate name(s) for
  352.           helpfile
  353.           PAGER Program to use for displaying help entries
  354.           HELP If set, is parsed as a command line argument before the
  355.           other arguments.  This allows setting of default options.
  356.           COLOR Environment variable - if set, is parsed as for the
  357.           4DOS COLOR command and used to set the screen colours for
  358.           the interactive selection windows.  The syntax is "fg ON bg"
  359.           where fg and bg are foreground and background colours taken
  360.           from the from the list "BLACK BLUE GREEN CYAN RED MAGENTA
  361.           YELLOW GRAY".  For example, COLOR=BLUE ON YELLOW
  362.  
  363.      BUGS
  364.           It would be useful if the last help entry viewed were to
  365.           remain on the screen at exit.  Since the help program has no
  366.           control over which pager is used, this is not always
  367.           possible.  It is also not possible to preserve the screen
  368.           when recursive calls are made to the cross-reference
  369.           feature.  In general, for any given pager, the best
  370.           combination of -c and -p options will need to be determined
  371.           empirically.
  372.  
  373.      AUTHORS
  374.           Original Author:  uwmacc!harvard!killer!wnp (Wolf Paul)
  375.           Environment variable handling by:  plocher@uwspan.uucp (John
  376.           Plocher)
  377.           Addition of all -options, interactive mode, multiple
  378.           helpfiles and pretty much rewrote everything.
  379.           richard@calvin.ee.cornell.edu
  380.  
  381.           (Richard Brittain) School of Electrical Engineering,
  382.           Engineering and Theory Center, Cornell University, Ithaca NY
  383.           14853
  384.  
  385.           Code for the popen/pclose routines was taken from a BBS and
  386.           it bears no author name.
  387.  
  388.           Permission is granted to copy and use the compiled program
  389.           and documentation for any non-commercial use, provided all
  390.           copyright information is retained.
  391.  
  392.  
  393.      Page 6                                           (printed 2/15/91)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      HELP(1)                  MS-DOS utilities                  HELP(1)
  401.  
  402.  
  403.                        Copyright 1990 by Richard Brittain
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.